TCloud Assinador para Mac — estação de trabalho
===============================================

Assina PDF, XML e JSON neste Mac com certificado A1 (no Porta-Chaves), A3
(token) ou A3 em nuvem, com a mesma interface da versão Windows: escolha os
arquivos, o certificado e assine. Em "Posicionar e personalizar…" a chancela
do PDF é colocada com o mouse sobre a página, no tamanho que quiser, com
logomarca, título e campos. Abra o app "TCloud Assinador" (ou arraste os
arquivos sobre o ícone dele). Os assinados são salvos ao lado dos originais,
com "-assinado" no nome.

Pedidos do Atlas e do BookC: o sistema abre um link tcloudsign:// no
navegador e o assinador deste Mac abre sozinho, baixa os documentos, pede a
confirmação e o PIN, assina e devolve. Não há pareamento nem nada rodando em
segundo plano.

Antes de instalar
-----------------
1. O certificado:
   - A1: basta estar no Porta-Chaves. Se estiver só no arquivo .pfx/.p12,
     use "Importar A1…" no app (ou dê dois cliques no arquivo). Na primeira
     assinatura o macOS pergunta se o Python pode usar a chave: escolha
     "Sempre Permitir".
   - A3 em nuvem (remoteID da Certisign): o desktopID instalado e ABERTO
     na hora de assinar. O PIN e o código do celular são pedidos por ele.
   - A3: driver do token instalado (o do fabricante para Mac: SafeNet
     Authentication Client, SafeSign, Watchdata etc.). O assinador usa a
     biblioteca PKCS#11 que vem com o driver.
2. Python 3. Se não houver, o instalador abre a instalação das Ferramentas
   de Linha de Comando da Apple; depois é só rodar o instalador de novo.

Instalar
--------
Clique com o botão direito em "Instalar TCloud Assinador.command" e escolha
Abrir (na primeira vez o macOS pede essa confirmação, porque o arquivo veio
da internet). Confirme em Abrir.

Pelo Terminal, sem baixar nada à mão:
    curl -fsSL https://tcloudsoft.app/download/instalar-mac.sh | bash

Configurações do assinador (chancela, título, motivo e local, carimbo de
tempo/ACT e pasta de saída): botão Configurações, no topo do app. A ACT
configurada aqui também vale para os pedidos do Atlas e do BookC.

Na primeira assinatura pelo Atlas/BookC, o navegador pergunta se pode abrir o
TCloud Assinador (marque "sempre permitir" para o site) e o assinador pergunta
se confia no sistema (confirme).

Se algo não funcionar, rode no Terminal e envie o resultado ao suporte:
    /usr/bin/python3 "$HOME/Library/Application Support/TCloud/Assinador/tcloud_assistente.py" diagnostico

Para atualizar, rode o instalador da versão nova.
Para remover, use "Desinstalar TCloud Assinador.command".

Problemas comuns
----------------
- "Driver do token não encontrado": instale o driver do fabricante. Se ele
  estiver instalado num caminho diferente, informe o caminho da biblioteca
  PKCS#11 em ~/Library/Application Support/TCloud/Assinador/estacao.json:
      "pkcs11": "/caminho/para/a/biblioteca.dylib"
- Mac com processador Apple (M1 ou mais novo): o driver do token precisa ter
  versão para Apple Silicon.
- O botão "Adicionar…" não coloca o arquivo na lista: envie ao suporte o
  arquivo ~/Library/Logs/TCloudAssinador-app.log.
- Registros: ~/Library/Logs/TCloudAssinador.log e TCloudAssinador-app.log
